Skip to content

feat(appbar): modernize App bar to MD3 Expressive specification - #5173

Open
Priyanshu0007 wants to merge 1 commit into
callstack:mainfrom
Priyanshu0007:feat/modernize-appbar-md3
Open

Priyanshu0007 wants to merge 1 commit into
callstack:mainfrom
Priyanshu0007:feat/modernize-appbar-md3

Conversation

@Priyanshu0007

@Priyanshu0007 Priyanshu0007 commented Nov 5, 2026 •

Copy link
Copy Markdown

Motivation

Modernizes Appbar suite to MD3 Expressive specifications (#4973).

  • Flexible variants: medium-flexible (112/136dp), large-flexible (120/152dp).
  • Subtitle: Restored in Appbar.Content (bodyMedium, onSurfaceVariant).
  • Scroll behavior: useAppbarScrollBehavior for elevation & 64dp collapse.
  • Actions & Logo: Added filled/tonal actions and Appbar.Image.
  • TopAppBar: Exported TopAppBar alias and types.

Related issue

Closes #4973

Test plan

  • Unit tests & snapshots: yarn test Appbar
  • Verified on Android, iOS, and Web example showcase

Screenshots

Android iOS Web
Android iOS Web

- add medium-flexible (112/136dp) and large-flexible (120/152dp) variants
- deprecate medium and large baseline variants
- restore subtitle support with bodyMedium typography and onSurfaceVariant color
- support titleAlignment ('start' | 'center') across small and flexible modes
- add reactive scroll elevation and collapsing support via useAppbarScrollBehavior
- add support for filled ('contained') and tonal ('contained-tonal') trailing action buttons
- add Appbar.Image component for app bar logos and avatars
- export TopAppBar alias and corresponding types for MD3 modernization
- update unit tests, snapshots, and example showcase

Closes callstack#4973
@Priyanshu0007
Priyanshu0007 force-pushed the feat/modernize-appbar-md3 branch from 60a19c7 to 1f7e23e Compare November 7, 2026 18:51
@Doberjohn Doberjohn added this to the 6.1.0 milestone Nov 10, 2026
@Doberjohn Doberjohn mentioned this pull request Nov 10, 2026
7 tasks
@Doberjohn

Copy link
Copy Markdown
Collaborator

Appbar's direction for 6.0 was decided in #5150 (D7): it keeps its compound API, built on context, with the Material 3 Expressive variants as props. That landed today in #5218, which covers the flexible modes, filled and tonal actions (variant and width on Appbar.Action), and an isScrolled prop for the scrolled container color. So most of this PR is now in main, in a different shape.

What #5218 doesn't cover is a subtitle for the flexible modes, a scroll behavior hook and Appbar.Image. If you'd like to take one of those on, a small PR on top of main with one feature is the easiest for us to review, and it would go into 6.1 like this one. Otherwise we'll close this PR. Either way, thank you for the work you put into it.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: modernize App bar to MD3

2 participants